home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / dorman26.zip / DOORMAN.DOC next >
Text File  |  1992-07-05  |  39KB  |  826 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.           ╔═══════════════════════╗
  7.           ║  ┌──────┐   ┌──────┐  ║
  8.           ║  │ ░░░░ │   │ ░░░░ │  ║
  9.           ║  │ ░░░░ │ . │ ░░░░ │  ║
  10.           ║  │ ░░░░ │   │ ░░░░ │  ║
  11.           ║  │ ░░░░ │   │ ░░░░ │  ║
  12.    #######║  │ ░░#######│ ░░░░ #######       #######       #######
  13.   #       ║# │ ░#░░ │   # ░░░░#│  ║   #     #       #     #       #
  14. ####     ##########─┘  ########## ║  #########     #########     #########
  15.   #       ║#O┌──#───┐   #─────#┐  ║   #     #       #     #       #
  16.    #######║  │ ░░#######│ ░░░░ #######       #######       #######
  17.           ║  │ ░░░░ │   │ ░░░░ │  ║
  18.           ║  │ ░░░░ │   │ ░░░░ │  ║
  19.           ║  │ ░░░░ │   │ ░░░░ │  ║            The Door Manager.
  20.           ║  │ ░░░░ │   │ ░░░░ │  ║        The COMPLETE door systems
  21.           ║  │ ░░░░ │   │ ░░░░ │  ║           manager for Sysop's.
  22.           ║  └──────┘   └──────┘  ║
  23.           ╚═══════════════════════╝
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. ┌────────────────────────────────────────────────────────────────────────────┐
  32. │░░░░░░░▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓██  Table of Contents  ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒░░░░░░│
  33. └────────────────────────────────────────────────────────────────────────────┘
  34.  
  35.  
  36.    DISCLAIMER.........................................................Page 1
  37.  
  38.    WHAT IS IT?........................................................Page 2
  39.  
  40.    SYSTEM REQUIREMENTS................................................Page 3
  41.  
  42.    COMMAND LINE OPTIONS...............................................Page 4
  43.  
  44.    COMMAND LINE USEAGE.............................................Pages 5-9
  45.  
  46.    ERRORLEVELS........................................................Page 10
  47.  
  48.    BATCH FILES........................................................Page 11
  49.  
  50.    BATCH FILE SAMPLE..................................................Page 12
  51.  
  52.    CREDITS............................................................Page 13
  53.  
  54.    REGISTRATION.......................................................Page 14
  55.  
  56.  
  57.  
  58.  
  59.  
  60. ┌────────────────────────────────────────────────────────────────────────────┐
  61. │░░░░░░░▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  Disclaimer  ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒░░░░░░░│
  62. └────────────────────────────────────────────────────────────────────────────┘
  63.                                                                     Page 1
  64. Warning: I, Wayne Greer do not accept any responsiblity for loss,
  65. personal or commercial, incurred while operating this program.
  66. The first time you execute this program you are agreeing
  67. to assume full responsibility for any and all damages that may result
  68. and you execute this program at your own risk.
  69.  
  70. There is no warranty of any kind, expressed or implied including but
  71. not limited to warranties of merchantability and/or fitness for any
  72. purpose. There is no liability for any damage to data, property,
  73. or persons that may be caused directly or indirectly by the use of this
  74. program.
  75.  
  76. This program is being release under the Shareware concept. Shareware
  77. is NOT freeware or public domain software. Shareware is a wonderful
  78. concept, it allows you to try a program first before you purchase it.
  79.  
  80. Your use of this program for more than 30 days combined total use constitutes
  81. your agreement to abide by its licensing requirements. You agree to either
  82. register the program or stop using it.  ANY BBS operating as a fee
  83. oriented BBS in which user fees are charged for any access level,
  84. this program is considered a commercial product and requires registration.
  85.  
  86. Registering the program will entitle you to ALL updates and new releases.
  87. You will find a registration form at the end of this document.
  88. If you find this program useful, please fill it out and register your copy.
  89.  
  90. "DoorMan" and "The DoorManager" are copyrighted by Wayne Greer and ALL
  91. rights are reserved.
  92.  
  93.  
  94.  
  95.  
  96. ┌────────────────────────────────────────────────────────────────────────────┐
  97. │░░░░░░░▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  What is it?   ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░│
  98. └────────────────────────────────────────────────────────────────────────────┘
  99.                                                                     Page 2
  100. The DoorManager is a complete management utility for BBS SysOp's.
  101. Some of Doorman's features are:
  102.  
  103.            Limit users to the number of times per day they can
  104.             access any door you specify.
  105.  
  106.           ^Limit any user from accessing any door via a
  107.             twit file without changing their access level.
  108.             or reconfiguring your entire BBS for a few bad
  109.             users.
  110.  
  111.            Take any door off-line and mark it DOWN by adding its name
  112.             to one file, no need to reconfigure your entire BBS.
  113.  
  114.            Lock/Unlock specified doors for Multi-node systems.
  115.             This will prevent other nodes from accessing doors
  116.             that are not Multi-node compatible.
  117.  
  118.           ^Limit the hours during the day or night any door you specify
  119.             can operate.
  120.  
  121.            Substitute Locked DTE rate for callers baud rate.
  122.  
  123.            Limit users time upon entering a door.
  124.  
  125.            Support for PcBoard.sys(14.x), Dorinfo1.def, Dorinfo2.def,
  126.             Door.sys, Callinfo.bbs, and Chain.txt.
  127.  
  128.           ^Config file option that is NOT cryptic, place commands there
  129.             in any order and any number of options.
  130.             Command line options will have priority over the config file.
  131.  
  132.           ^In development, conversion routines to generate to/from
  133.             different callers formats. Current versions create FROM
  134.             PcBoard.sys and Door.sys to any format mentioned above.
  135.  
  136. ^ Feature available when registered.
  137.  
  138.  
  139.  
  140. ┌────────────────────────────────────────────────────────────────────────────┐
  141. │░░░░░░░▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  System Requirements  ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒░░░░░░░│
  142. └────────────────────────────────────────────────────────────────────────────┘
  143.                                                                      Page 3
  144. This program REQUIRES you have a 100% IBM compatible computer, MS-DOS 3.x or
  145. higher, an accurate system clock, and requires you to have a working
  146. knowledge of creating/editing batch files and working in a dos environment.
  147.  
  148. Multi-node systems MUST have SHARE installed for proper file management.
  149.  
  150. This program will NOT work on directories that have extensions.
  151. Example:
  152. C:\BBS.1\Program.exe  where the directory BBS.1 IS a valid directory name
  153. but is not supported with this program.
  154.  
  155. The Text files you create MUST end each line in a cr/lf.  Every text
  156. editor I have ever used does this already, however some may not. If you run
  157. into problems in reading some of your data, this may be the reason why.
  158. An easy way to check this is to create a new file with your editor and save
  159. it without entering any data, next check the file size of the new file.
  160. Editors that create a CR/LF will have a file size of 2 bytes.  If your editor
  161. only uses a LF only it will be 1 byte in size.
  162. Another way to check, if your favorite text reader has a HEX mode toggle,
  163. read a file you have created, each line should end with a 0A 0D at the end
  164. of each line which resembles a single music note followed by a white square
  165. with a hole in the center.
  166.  
  167. This program also requires you read and understand this doc file, and
  168. you fully understand how to use this program.
  169.  
  170. When you register this program, you will be sent a registration number.
  171. Use your text editor and create a file called DOORMAN.KEY in the same
  172. directory where DOORMAN.EXE is located.
  173. This file should contain on line 1 your name and case is significant!
  174. (John Doe is NOT the same as JOHN DOE).
  175. on line 2 place the registration number you will be sent.
  176.  
  177. This program was written in Borlands Turbo C++.
  178. It has been sucessfully tested on a 286 single node BBS and
  179. a Multi_node BBS running under DESQview 2.42 and QEMM 6.02 with no problems.
  180.  
  181.  
  182. ┌────────────────────────────────────────────────────────────────────────────┐
  183. │░░░░░░▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██ Command Line Options   ██▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒░░░░░░│
  184. └────────────────────────────────────────────────────────────────────────────┘
  185.                                                                       Page 4
  186.  
  187. Since this program is highly configurable and does so many things, at first
  188. glance it may seem a little overwhelming.  It is suggested that you do not
  189. look at the entire range of options your first time.  This will simplify
  190. learning all about this program.  Pick one or two options and configure them,
  191. look and see how it works, make changes as needed, then when you feel
  192. comfortable with what you've done, add more.
  193.  
  194. When entering commands you may specify a '-' (dash) or a '/' (slash),
  195. and may enter them in any order,  however some commands
  196. REQUIRE you specify other commands.  The commands are not CaSe SenSiTive.
  197. When we mention to enter the Full path and file name, this is best, however
  198. we will default to read the file in the current directory.  Example, if you
  199. are currently in the c:\bbs directory you can change the first example shown
  200. below to read /adoorman.cfg.
  201.  
  202.         /ac:\bbs\doorman.cfg   ^(A)lternate parameters.
  203.         /Bc:\bbs\pcboard.sys    (B)bs callers file. location AND filename.
  204.         /Cc:\doors\door.sys    ^(C)onvert to Door.sys file format.
  205.         /Dname                  (D)oor name, Max of 8 characters!
  206.     /Fc:\bbs\timefile.dat    (F)ile that contains # of times data of users.
  207.     /H38400            (H)igh speed lock, specify locked rate.
  208.     /Lc:\bbs\nodelock.dat    (L)ock data file full path/file name.
  209.     /M30            (M)inutes to allow maximum.
  210.     /R            (R)estore original callers file.
  211.     /N2            (N)umber of times to allow per day in the door
  212.         /Tc:\bbs\twitfile.dat  ^(T)wit data file, full path/file name
  213.     /Uc:\bbs\nodelock.dat    (U)nlock data file, full path/file name
  214.         /Q                     ^(Q)uiet mode, turns off beeps.
  215.  
  216. Doorman <enter> will give you a brief list of these commands.
  217.  
  218. Doorman /? <enter> will list the error levels for quick reference.
  219.  
  220.  
  221. ^Features available when registered.
  222.  
  223.  
  224.  
  225. ┌────────────────────────────────────────────────────────────────────────────┐
  226. │░░░░░░▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  Command Line Useage   ██▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒░░░░░░│
  227. └────────────────────────────────────────────────────────────────────────────┘
  228.                                                                     Page 5
  229.  
  230. Commands          Description
  231. ~~~~~~~~          ~~~~~~~~~~~
  232. /B                (B)BS information.  This is the FULL path AND
  233.                   file name of the BBS caller information. your BBS creates.
  234.                   Example:  /bC:\BBS\PcBoard.sys
  235.                   (note there is no space).  This is required on almost all
  236.                   usage.
  237.                   Supported types are Dorinfo1.def, Dorinfo2.def, Door.sys,
  238.                   Chain.txt, Callinfo.bbs and PcBoard.sys(14.x versions).
  239.  
  240. /D                (D)oor name. This is the name of the door we are
  241.                   working with.  You Cannot use the name NONE or DOWN. They
  242.                   are reserved words for this program which we will explain
  243.                   later.  There is a limit of 200 doors in this file.
  244.                   I figured 200+ node BBS's aren't really interested in
  245.                   doors anyway.  Also Door names cannot begin with a number.
  246.                   Example: /dXWAR.
  247.                            /Dnone  <-The word 'NONE' is NOT ALLOWED!
  248.                            /Ddown  <-The word 'DOWN' is NOT ALLOWED!
  249.                            /D1war  <-Begins with a number, NOT ALLOWED!
  250.  
  251. /Nx               (N)umber of times user is allowed to access the door per
  252.                   day.  The 'x' in the /Nx represents the actual number of
  253.                   times  per day to allow.
  254.                   Example:  /N2
  255.                   This would allow the caller 2 times per day.
  256.                   You must of course specify which door with the /D command
  257.                   and also you must use the following /F command.
  258.  
  259. /F                (F)ile that contains the times per day information.
  260.                   Example /Fc:\bbs\timetrip.dat
  261.                   This data is stored in a normal text format like:
  262.                   01-15-92 XWAR JOHN MODEMER
  263.                   01-15-92 XWAR JIM MODEMER
  264.                   01-15-92 SLAP BETTY TWITSTER
  265.                   etc.
  266.                   If this file does not exist, it will be created
  267.                   automatically, you will have to manually edit this file
  268.                   from time to time, or either delete it in your nightly
  269.                   event maintanence.
  270.  
  271.  
  272.  
  273. ┌────────────────────────────────────────────────────────────────────────────┐
  274. │░░░░░░▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  Command Line Useage   ██▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒░░░░░░│
  275. └────────────────────────────────────────────────────────────────────────────┘
  276.                                                                     Page 6
  277.  
  278. /T                (T)wit file.  This is a full path/file name to your twit
  279.                   file.  This is a file you will have to create with your
  280.                   favorite text editor.  This program does not write to
  281.                   or modify information in this file.  In this file you
  282.                   will have to add the name of the door and the caller's
  283.                   name.  This will prevent THAT caller from accessing
  284.                   any door you have specified in the file.  This is excellent
  285.                   for limiting access to a specific user or users without
  286.                   altering their access level or reconfiguring your entire
  287.                   BBS's access levels for a few callers.   Previously we
  288.                   stated the NONE and DOWN were reserveds word for a door
  289.                   name and this option is the reason why.
  290.                   Your twit file MUST be formatted in this way:
  291.                   XWAR JOHN SMITH
  292.                   SLAP JOHN SMITH
  293.                   NONE BETTY MODEMER
  294.                   MOPE 23:00 07:00
  295.                   GREN DOWN
  296.                   etc.
  297.                   Please use only CAPITAL letters when entering this data.
  298.                   Time of operation of the Door must be in Military format.
  299.                   The example above means that John Smith cannot play XWAR
  300.                   or SLAP games.  Betty Modemer does not have access to any
  301.                   door because of the NONE reserved keyword.
  302.                   The door MOPE is offline between the hours of 11:00 p.m.
  303.                   and 7:00 a.m.  The door GREN is down and cannot be accessed.
  304.                   You must of course tell us where this file is located and
  305.                   its filename.
  306.                   Example:  /Tc:\bbs\twitlist.dat
  307.                   This is the full path/file name to the data file containing
  308.                   the twit list.
  309.                   This feature is available when registered.
  310.  
  311. /L & /U           (L)ock and (U)nlock.  If you are using a Multi-node BBS
  312.                   you may have certain doors that cannot be accessed at the
  313.                   same time by multiple nodes.  This option will allow you
  314.                   to lock and unlock doors by name.
  315.                   Example /Lc:\bbs\locknode.dat   to lock a door.
  316.                           /Uc:\bbs\locknode.dat   to unlock a door.
  317.                   You must also specify the door name with the /D command.
  318.                   Example:
  319.                   DOORMAN /Dhwar /Lc:\bbs\locknode.dat
  320.                   This would LOCK the door named HWAR from other node access.
  321.                   DOORMAN /dgwar /uc:\bbs\locknode.dat
  322.                   This would UNLOCK the door name hwar and allow other nodes
  323.                   to access it.
  324.  
  325.  
  326. ┌────────────────────────────────────────────────────────────────────────────┐
  327. │░░░░░░▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  Command Line Useage   ██▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒░░░░░░│
  328. └────────────────────────────────────────────────────────────────────────────┘
  329.                                                                       Page 7
  330. /Mxx            (M)inutes (M)ax to allow in this door.  The xx of the /Mxx
  331.                 is the number of minutes.
  332.                 Example /M30
  333.                 This will not increase the callers time to 30 minutes,
  334.                 it will reduced it to 30 minutes provided the caller has
  335.                 30 or more minutes remaining of board time.
  336.                 Please note, the caller information file you specify
  337.                 with the /B command will have a file created with the
  338.                 same name except will have an extension of .!!!
  339.                 See notes on the /C Conversion routine.
  340.                 If you use Dorinfo1.def, a file will be created called
  341.                 Dorinfo1.!!! in the same directory as Dorinfo1.def is located.
  342.                 This is necessary because of the following command.
  343.  
  344. /R              (R)estore.  If you reduce a callers time, you may need to
  345.                 restore their original caller info files on returning to the
  346.                 BBS.  If the caller has 60 minutes and you reduce it to 30,
  347.                 they stay in a door for 25 minutes, when they return to the
  348.                 BBS they may have only 5 minutes left.
  349.                 Example /rc:\bbs\Chain.txt
  350.                 There will be a file called Chain.!!! in the BBS directory
  351.                 We will simply copy this file over the Chain.txt file that
  352.                 is currently there and then delete the .!!! file.  When your
  353.                 BBS loads, it will read the  original caller info file and
  354.                 the caller will have their remaining time restored.
  355.                 if your BBS does not require this file, just delete it
  356.                 somewhere in your batch file.
  357.  
  358. /Hxxxxx         (H)igh speed lock.  Some BBS types do not provide a locked
  359.                 baud rate, instead providing the callers baud rate.  If you
  360.                 run a high speed modem, you probably have some doors that
  361.                 require you substitute the callers rate with the locked DTE
  362.                 rate.
  363.                 Example /H38400
  364.                 This would substitute the callers baud rate with 38400.
  365.                 Pcboard.sys file already contains both callers rate and
  366.                 locked rate and therefore will not be adjusted even if
  367.                 you tell it to.  See notes on the /C Conversion.
  368.  
  369.  
  370.  
  371. ┌────────────────────────────────────────────────────────────────────────────┐
  372. │░░░░░░░▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓██  Conversion Routines  ██▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒░░░░░░│
  373. └────────────────────────────────────────────────────────────────────────────┘
  374.                                                                       Page 8
  375. /C              (C)onvert.  This command will convert from your type of
  376.                 caller info to any of these formats:
  377.                 Dorinfo1.def, Chain.txt, Callinfo.BBS, Door.sys, PcBoard.sys.
  378.                 The current version (2.2) of this program only converts FROM
  379.                 PcBoard.sys based systems such as PcBoard and FeatherNet,
  380.                 and from Door.sys to any of the formats mentioned above.
  381.                 PcBoard.sys and PcBoard.dat files MUST be located in the
  382.                 same directory.  The PcBoard.dat file MUST conform to
  383.                 at least version 14.2 of that file format.
  384.                 You may include the complete path to the new file you would
  385.                 like to create and defaults to the current directory.
  386.                 Examples:
  387.                 /Cd:\doors\xwar\door.sys
  388.                 /Cdorinfo1.def
  389.                 etc.
  390.                 You must also specify where your current callers info file
  391.                 is located with the /b command.  A complete command line
  392.                 would look something like:
  393.                 Doorman /bc:\bbs\pcboard.sys /cd:\doors\xwar\door.sys
  394.                 We hope to be adding more formats to convert to/from in
  395.                 the near future.
  396.                 If you limit the callers time with the /m command, and/or
  397.                 substitute the locked DTE rate with the /H command, only the
  398.                 new created file will have the changes.
  399.                 No adjustments will be made to your original BBS file.
  400.                 If you specify a conversion and also check for node lock
  401.                 status or twit file status, etc, these test will be
  402.                 checked and satisfied BEFORE the conversion will begin.
  403.                 If any of the above test fail for some reason, the conversion
  404.                 will not take place.
  405.                 There are of course some information available in some
  406.                 formats that cannot be found in others.  If your BBS type
  407.                 does not have information available, certain values will
  408.                 be substituted.  For example, PcBoard based systems have
  409.                 no provision for the callers birthday, this value will be
  410.                 substitued, etc.
  411.  
  412.                 This Feature is available to registered users only.
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421. ┌────────────────────────────────────────────────────────────────────────────┐
  422. │░░░░░░▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  Command Line Useage   ██▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒░░░░░░│
  423. └────────────────────────────────────────────────────────────────────────────┘
  424.                                                                        Page 9
  425.  
  426. /A              (A)lternate commands.  This is the full path\file name of the
  427.                 file you may use (when registered) to store many of the
  428.                 commands mentioned above.  Actually you may store almost
  429.                 everyone of them, it is not important these command be in
  430.                 any order in the config file, just create a normal text file
  431.                 and type in the options you normally would on the normal
  432.                 command line.  Your file may look something like this:
  433.                 /tc:\bbs\twitlist.dat
  434.                 /bc:\bbs\dorinfo1.def
  435.                 /lc:\locknode.dat
  436.                 /uc:\locknode.dat
  437.                 etc...
  438.                 you may enter as few or many as you wish, ANY commands you
  439.                 enter on your command lines in your batch files will have
  440.                 priority over the config file.
  441.                 When locking and unlocking door, you still must specify
  442.                 a /l or a /u for lock or unlock since you may store both
  443.                 in the config file.
  444.                 DOORMAN /Ac:\bbs\doorman.cfg /l /dgwar
  445.                 Your command line told us where the config file was, we
  446.                 will read it and get the path\filenames of the twitlist,
  447.                 where your bbs caller information file is, the locknode
  448.                 data file.  Next your command line told us to LOCK the
  449.                 door GWAR.
  450.                 A bit more creative would be to store the name of the
  451.                 door, and limit the number of times per day to say
  452.                 /n2 in the config file.  If the name of the door is always
  453.                 the same, your callers would be allowed to play any two
  454.                 door(s) then they cannot play any other games and must spend
  455.                 their time in the message/file areas.
  456.                 This feature is available when registered.
  457.  
  458. /Q              (Q)uiet mode, a fatal error condition or an error
  459.                 establishing file access will inform you with
  460.                 a beep.  If you wish to silence this warning, use
  461.                 the /q but this is not recommended.
  462.                 Unregistered users will here a beep from time to time
  463.                 anyway, the (Q)uiet option is available for registered
  464.                 users only.
  465.  
  466.  
  467.  
  468.  
  469. ┌────────────────────────────────────────────────────────────────────────────┐
  470. │░░░░░░░▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  ErrorLevels   ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒░░░░░░░│
  471. └────────────────────────────────────────────────────────────────────────────┘
  472.                                                                      Page 10
  473. Next we need some method of making all of this work in your batch files
  474. that run your doors.  This is done with the dreaded ERRORLEVEL.
  475. The errorlevels you will get are:
  476.  
  477. ERRORLEVEL:    Description:
  478. ~~~~~~~~~~~    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  479.    10          This is a fatal error, meaning we detected a error on trying
  480.                to create or update a file, if you do not specify a proper
  481.                file/path this error could occurs or else for some other
  482.                reason the program just went nuts.
  483.  
  484.     9          Invalid commands entered, some features require other commands
  485.                to operate properly, at least one or more was missing.
  486.  
  487.    6-8         Reserved for future options.
  488.  
  489.     5          Door has been marked as DOWN via the twit file.
  490.  
  491.     4          Door is outside specified hours of operation.
  492.  
  493.     3          Caller is in the Twit list for the door you specified.
  494.  
  495.     2          The caller has accessed the door you specifed the maximum
  496.                number of times you specifed.
  497.  
  498.     1          The door you specified is currently locked by another node.
  499.  
  500.     0          All the options/checks etc you specified were successful.
  501.                Although we make alot of test to make sure you have entered
  502.                all the proper commands needed for successful operation,
  503.                is may still be possible to get an ERRORLEVEL of 0 even
  504.                if you have specified test and checks to be made, and you
  505.                did not enter all of the other additional commands required
  506.                to complete the operation.
  507.                You have been warned, so make sure you understand how to
  508.                properly use this program before you start.
  509.  
  510.  
  511. ┌────────────────────────────────────────────────────────────────────────────┐
  512. │░░░░░░░▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  Batch FIles   ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░│
  513. └────────────────────────────────────────────────────────────────────────────┘
  514.                                                                      Page 11
  515. Some notes on Errorlevels.  In a batch file, errorlevels MUST be in
  516. desending order and errorlevels are tested for 'if greater than or equal to'.
  517.  
  518. rem Sample batch file
  519. program.exe
  520.  
  521. If ERRORLEVEL 5 goto DO_THIS
  522.  
  523. if ERRORLEVEL 3 goto DO_THAT
  524.  
  525. :DO_THIS
  526. doit.exe
  527.  
  528. :DO_THAT
  529. someprgm.exe
  530.  
  531. etc
  532. If the PROGRAM.EXE exits with an error level of 4, then the
  533. 'IF ERRORLEVEL 3 GOTO DO_THAT '  gets executed.  You should write your batch
  534. files accordingly.
  535.  
  536.  
  537. DOS has a limit of 128 characters per command line.  If you use all the
  538. options specified, you may run into problems.  You may consider cutting
  539. down on your file names to use all the options.  The following line may
  540. wrap around if you print this doc file, but it is 128 characters long
  541. and does execute on my system.
  542.  
  543. Doorman /Bc:\bbs\node1\dorinfo1.def /Dxwar /H38400 /N100 /M100 /Lc:\bbs\nodelock.dat /Fc:\bbs\timefile.dat /tc:\bbs\twitlist.dat
  544. Don't forget, when you register, a config file can be created and you can
  545. store almost all of this information in the config file.
  546.  
  547.  
  548. ┌────────────────────────────────────────────────────────────────────────────┐
  549. │░░░░░░░▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██  Batch FIles   ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░│
  550. └────────────────────────────────────────────────────────────────────────────┘
  551.                                                                      Page 12
  552. You might consider informing your callers to what is happening if they
  553. cannot access a door.  I use a program called SENDCOM, an excellent
  554. program written and released into the Public Domain by Bill Shields.  Here
  555. is a sample batch file I use on my system.
  556. REM Batch file starts here!
  557. CD\BBS
  558. doorman /Lc:\node.dat /TC:\TWIT.DAT /Dxwar /m30 /n2 /Bc:\bbs\pcboard.sys /Fc:\times.dat
  559. IF ERRORLEVEL 6 GOTO CONTINUE   REM this gets ALL errorlevels 6 and above.
  560. IF ERRORLEVEL 5 GOTO DOWN       REM Door has been marked down.
  561. IF ERRORLEVEL 4 GOTO HOURS      REM Door is outside operating hours.
  562. IF ERRORLEVEL 3 GOTO TWIT       REM User is a twit.
  563. IF ERRORLEVEL 2 GOTO TIMES      REM Caller already accessed door 2 times today.
  564. IF ERRORLEVEL 1 GOTO LOCK       REM Door is locked by another node.
  565. CD\WAR
  566. war war.cfg
  567. cd\bbs
  568. doorman /Uc:\node.dat /Dxwar    REM Unlock the door for other node access.
  569. GOTO continue
  570. :HOURS
  571. sendcom 1 CR Sorry but that door is off-line between the hours of
  572. sendcom 1 CR 11:00 p.m. and 6:00 a.m. each day. Please try back outside
  573. sendcom 1 CR these hours.
  574. GOTO continue
  575. :DOWN
  576. sendcom 1 CR Sorry, but that game is currently off-line, please try another game.
  577. GOTO continue
  578. :TWIT
  579. sendcom 1 CR Sorry, the sysop has specified you are not allowed to play this game.
  580. GOTO continue
  581. :TIMES
  582. sendcom 1 CR Sorry, only 2 turns per day are allowed for XWAR.
  583. sendcom 1 CR Please try back again tomorrow.
  584. GOTO continue
  585. :LOCK
  586. sendcom 1 CR Sorry, that door in currently in use by another node.
  587. sendcom 1 CR Please try back again later.
  588. GOTO continue
  589. :CONTINUE
  590. BBS.BAT
  591. REM end of batch file.
  592. It looks a bit complicated but it is not really.  Just experiment adding
  593. an option or two as you go if this seems too complicated, you'll get the
  594. hang of it.  If you don't care to inform your callers, just run doorman
  595. on the next line just put 'IF ERRORLEVEL 1 GOTO CONTINUE' and just reload
  596. your board. ALL errorlevels 1 and up will get caught and will jump to the
  597. :continue  section.                                                             
  598.  
  599.  
  600. ┌────────────────────────────────────────────────────────────────────────────┐
  601. │░░░░░░░░▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓██ Credits  ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░│
  602. └────────────────────────────────────────────────────────────────────────────┘
  603.                                                                      Page 13
  604. The following programs/words appearing in this document are registered
  605. trademarks of their respective company or group.
  606.  
  607.          DESQview/QEMM              Quarterdeck Office Systems
  608.          IBM PC                     International Business Machines, Inc
  609.          MS-DOS                     Microsoft, Inc
  610.          Borland Turbo C++          Borland International, Inc
  611.          DoorMan                    Wayne Greer
  612.          The DoorManager            Wayne Greer
  613.          PcBoard                    Clark Development Company
  614.          FeatherNet                 FeatherNet Software and/or Ron Pierce
  615.  
  616. If any other copyrights held and not listed please inform me and I'll
  617. add it immediately to this document.
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632. ┌────────────────────────────────────────────────────────────────────────────┐
  633. │░░░░░░░░▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓██  Registration  ██▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒░░░░░░░░░│
  634. └────────────────────────────────────────────────────────────────────────────┘
  635.                                                                    Page 14
  636. Here comes the standard song and dance you've seen with many other programs.
  637. Over the last few years, I have become very dissapointed by people that
  638. would not register a program regardless of what it does or how well it does
  639. it.
  640. If you use this program and find it usefull, registering it
  641. is simply the right thing to do.
  642.  
  643. As a sysop myself, I frequently run across programs that are basically
  644. worthless or the registration for what the program does is ridiculous.
  645. I have seen programs that do half as much as this one and sell for twice
  646. the price and more.
  647. A good program should be self evident and I believe the cost of this
  648. program for what it does is more than fair and very reasonable.
  649.  
  650. You may registrations in U.S. Dollars or provide the credit card information
  651. stated below, or either call:
  652.  
  653.           ██████████████████████████████████████████████████████
  654.           █▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀█
  655.           █▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀ Wayne's World BBS ▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀█
  656.           █▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀█
  657.           ██████████████████████████████████████████████████████
  658.  
  659.                          (918) 665-2711 2400 
  660.                         (918) 665-0885 HST DS 
  661.                      1.5 Gig On-Line and growing 
  662.  
  663. and register while on-line using your Visa/MasterCard.
  664. The registration cost is only $10.00.  You will be sent a registration
  665. certificate within a few days.  Your registration will be valid for ALL
  666. future versions of this program.  Oklahoma residents and/or certificates
  667. shipped to Oklahoma addresses MUST include state sales tax.
  668.  
  669.  
  670.                      ^ ^ ^ Detach Mailer here  ^ ^ ^
  671.   REGISTRATION FORM:
  672.  
  673.   Name to be registered:_____________________________________
  674.              < Only Sysops full real name will be registered >
  675.  
  676.   BBS Name :_________________________________________________
  677.  
  678.   Voice Telephone number:____________________________________
  679.  
  680.   BBS Telephone number:______________________________________
  681.  
  682.   Your Complete mailing address:
  683.  
  684.                 NAME:_____________________________
  685.  
  686.              ADDRESS:_____________________________
  687.  
  688. CITY STATE & ZIPCODE:_____________________________
  689.  
  690. Comments about DoorMan:___________________________________________________
  691.  
  692. __________________________________________________________________________
  693.  
  694. __________________________________________________________________________
  695.  
  696.  
  697.   [ ] Doorman registration only..................$10.00
  698.  
  699.   [ ] Doorman registration plus one year of BBS
  700.       subscription, includes 1 hour per day and
  701.       no file ratios
  702.       Doorman registration is $6.00,
  703.       BBS is $19.00..............................$25.00
  704.   [ ] Optional, I would like the latest version of the program
  705.       sent to me on diskette.  All disk are the same price.
  706.       Please mark type below.  Please help us with keeping cost
  707.       down and only mark the minimum your system will allow.
  708.       [ ] 5 1/4 LowDensity  [ ] 5 1/4 High Density
  709.       [ ] 3.5 LowDensity [ ] 3.5 HighDensity
  710.       Diskette....................................$5.00
  711.  
  712. Please select form of registration:
  713.  
  714.       [  ] Check or Money order made payable to Wayne Greer.
  715.  
  716.       [  ] Visa
  717.  
  718.       [  ] Mastercard
  719.  
  720. Card Number:_____________________________________________
  721.  
  722.  Expiration:_____________________________________________
  723.  
  724.        Name:_____________________________________________
  725.                      (Name on the Credit Card)
  726.  
  727.   Signature:_____________________________________________
  728.                (required for credit card processing)
  729.  
  730.  
  731. Oklahoma residents, MUST include state sales tax.
  732. If you registering Doorman only, include sales tax on $10.00,
  733. Combination of BBS subscription and Doorman include
  734. sales tax on $6.00.
  735. For diskettes, add the additional tax on $5.00.
  736. NO ORDERS WILL BE SHIPPED TO OKLAHOMA ADDRESSES WITHOUT IT!
  737.  
  738.                       ^ ^ ^ Fold at perf here ^ ^ ^
  739.     _____________________________                                     Place
  740.  
  741.     _____________________________                                     Stamp
  742.  
  743.     _____________________________                                      Here
  744.  
  745.  
  746.  
  747.  
  748.  
  749.                                      Wayne Greer
  750.                                      P.O. Box 690891
  751.                                      Tulsa OK 74169-0891
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.                         ^ ^ ^ Fold again here ^ ^ ^
  766. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  767. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  768. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  769. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  770. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  771. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  772. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  773. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  774. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  775. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  776. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  777. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  778. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  779. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  780. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  781. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  782. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  783. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  784. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  785. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  786. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  787. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  788. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  789. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  790. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  791. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  792. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  793. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  794. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  795. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  796. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  797. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  798.  
  799.                         ^ ^ ^  Detach at perf here ^ ^ ^
  800.  
  801. Directions for the instant mailer:
  802.  
  803. Detach where shown. Fill out the form.
  804. Fold in half at the perf as shown so that the address is facing OUT.
  805. Fold again where indicated so that the address is STILL facing out.
  806. <<<-------------remove 'tractor feeds' (if any) on the edges here ---------------->>>
  807. Enclose your registration, tape or staple the edges, stamp it and mail.
  808. The post office may think this is an oversize envelope, if this is printed
  809. on regular 8 1/2 by 11 pages it IS NOT!
  810. it requires the same stamp as any regular envelope.
  811.  
  812. You may of course use a regular envelope if you wish, detach the top portion
  813. of the mailer, fill it out and mail in your favorite envelope along with your
  814. registration.
  815.  
  816. Orders that do not contain registration fees and incomplete forms will not
  817. be processed.
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.